跳到主要内容

使用 Node-RED 发送邮件

本教程演示如何通过 Node-RED 设置从 OV80i 摄像头自动发送邮件通知。您将学习配置 Gmail 集成,并创建能够将检查警报、系统状态更新和故障通知直接发送到您的邮箱的流程。

您将构建: 使用 Gmail SMTP 的自动邮件系统,将 OV80i 的检查结果、警报和通知发送给指定收件人。

实际应用场景: 当检查失败时即时收取邮件警报,向管理层发送日常质量报告,或在系统出现问题时通知维护团队——全部由您的视觉检测系统自动完成。

先决条件

  • OV80i 摄像头,具备 Node-RED 访问权限
  • 用于发送邮件的 Gmail 账户
  • 基本了解 Node-RED flow(流程)
  • 访问 Google 账户的安全设置

教程概览

我们将构建: 一个 Node-RED 流,能够自动发送包含检查结果和系统警报的邮件通知。

所需时间: 20-30 分钟(含 Gmail 设置)

所学技能: Gmail 应用密码设置、SMTP 配置、自动邮件通知

步骤 1:设置 Gmail 应用密码

1.1 启用两步验证

  1. 登录 Google 账户,网址 accounts.google.com
  2. 在左侧导航菜单中点击“安全性”
  3. 找到“登录到 Google” 部分
  4. 点击“2-Step Verification”
  5. 按提示操作以启用两步验证(若未启用)
备注

在您创建应用密码之前需要启用两步验证。

1.2 生成应用密码

  1. 在启用两步验证后返回安全性页面
  2. 点击“App passwords”(在“登录到 Google”下)
  3. 选择“Mail”作为应用类型
  4. 选择“Other”作为设备类型
  5. 输入名称,如“OV80i Node-RED Email”
  6. 点击“Generate”

1.3 保存您的应用密码

  1. 复制 Google 显示的 16 位密码
  2. 安全保存——您将需要它来配置 Node-RED
  3. 注:此密码仅显示一次。如丢失,请重新生成

检查点: 您应已为 Node-RED 保存一个 16 位的 Gmail 应用密码。

步骤 2:安装 Email 节点(如有需要)

2.1 检查是否有 Email 节点

  1. 在 OV80i 摄像头上的 Node-RED 打开
  2. 在左侧调色板的输出区域查找名为 'email' 的节点
  3. 若找不到,则需要安装 email 包

2.2 安装 Email 包(如需)

  1. 在 Node-RED 中点击左上角的汉堡菜单(≡)
  2. 选择“管理调色板”
  3. 点击“Install”选项卡
  4. 搜索 “node-red-node-email”
  5. 在软件包旁点击“Install”

步骤 3:创建基础邮件流

3.1 添加所需节点

  1. 导航到 IO Block > Configure I/O 以访问 Node-RED
  2. 从调色板将以下节点拖放到画布上:
    • Inject 节点(用于测试)
    • Email 节点(来自输出区域)
  3. 将 Inject 输出连接到 Email 输入

3.2 基本流结构

Inject → Email

流的目的: 用于测试和基本通知的简易邮件发送。

image.png

第4步:配置邮件内容

4.1 设置注入节点

  1. 双击注入节点以打开属性
  2. 设置有效载荷
    • 有效载荷类型: "string"
    • 有效载荷值:您的邮件正文文本(例如,"来自 OV80i 的检测警报")
  3. 添加邮件主题
    • 点击 "+ add" 以添加属性

    • 属性名称: "topic"

    • 属性值:您的邮件主题(例如,"OV80i Inspection Alert")

      image.png

4.2 示例基本配置

有效载荷(邮件正文):

Inspection completed at Station 1
Status: Alert triggered
Time: Check timestamp for details

主题(邮件主题):

OV80i Inspection Alert - Station 1

4.3 保存注入配置

  1. 为该节点命名,如 "Email Trigger"
  2. 点击 "Done" 以保存配置

第5步:配置 Email SMTP 设置

5.1 设置邮件节点

  1. 双击邮件节点以打开属性
  2. 配置基本设置
    • 名称: "Send Alert Email"(或描述性名称)
    • 收件人: 收件人邮箱地址(例如 quality@company.com

5.2 配置 Gmail SMTP

  1. 服务器smtp.gmail.com
  2. 端口465
  3. 勾选 "Use secure connection"
  4. 认证类型Basic
  5. 用户名:您的完整 Gmail 地址(例如 alerts@company.com
  6. 密码:来自步骤 1 的 16 位应用专用密码

5.3 安全设置

  1. 勾选 "Check server certificate is valid"
  2. 请验证所有设置 是否正确输入
  3. 点击 "Done" 以保存邮件节点配置

检查点: 您的邮件节点不应显示错误指示,并应显示收件人地址。

image.png

第6步:测试您的邮件流程

6.1 部署与测试

  1. 点击 "Deploy" 按钮位于右上角
  2. 等待 "Successfully deployed" 消息
  3. 点击注入节点按钮(左侧的灰色方块)

6.2 验证邮件送达

  1. 检查收件人邮箱的测试邮件
  2. 如邮件未出现在收件箱,请检查垃圾邮件文件夹
  3. 在 Node-RED 调试面板中查找任何错误信息

6.3 如有需要,请排除故障

常见问题:

  • 错误的应用专用密码:重新生成 Gmail 应用密码
  • SMTP 设置:请验证服务器和端口是否正确
  • 防火墙:确保允许出站 SMTP 流量

第7步:与检测结果的集成

7.1 连接到检测流程

要根据检测结果发送邮件:

  1. 找到您的主检测流程(以 All Block Outputs 开头)
  2. 将您的邮件流程作为从检测处理的分支添加
  3. 在检测逻辑之后连接,但与最终结果并行

7.2 示例集成流程

All Block Outputs → [Inspection Logic] → Final Pass/Fail

Format Email → Send Email

image.png

7.3 动态电子邮件内容

Replace the inject node with a function node for dynamic content:

// Dynamic email based on inspection results
const result = msg.payload.result ? "PASSED" : "FAILED";
const timestamp = new Date().toLocaleString();
const station = global.get("station_name") || "Unknown Station";

// Set email subject
msg.topic = `Inspection ${result} - ${station}`;

// Set email body
msg.payload = `Inspection Report:
Status: ${result}
Station: ${station}
Time: ${timestamp}
Image: ${msg.payload.image_url || "No image available"}

Please review and take appropriate action.`;

return msg;

Step 8: 完整流程示例

8.1 导入现成的流程

您可以导入此完整流程的 JSON:

[
{
"id": "email_node_1",
"type": "e-mail",
"name": "Send Inspection Alert",
"server": "smtp.gmail.com",
"port": "465",
"secure": true,
"authtype": "BASIC",
"to": "quality@company.com"
},
{
"id": "format_email",
"type": "function",
"name": "Format Email Content",
"func": "const result = msg.payload.result ? 'PASSED' : 'FAILED';\nmsg.topic = `Inspection ${result}`;\nmsg.payload = `Status: ${result}\\nTime: ${new Date()}`;\nreturn msg;"
}
]

8.2 根据需要自定义

  1. 为贵组织更新电子邮件地址
  2. 根据具体需求修改电子邮件内容
  3. 调整时序和触发条件
  4. 在生产部署之前进行充分测试

故障排除

常见问题

问题症状解决方案
认证失败"Login failed" 错误验证应用密码是否正确并启用两步验证
连接超时未发送邮件,出现超时错误检查防火墙设置,验证 SMTP 服务器和端口
邮件进入垃圾邮箱邮件投递但在垃圾邮件文件夹将发件人添加到安全列表,改进邮件内容
流程未触发无调试输出检查流程连接和触发条件

调试您的邮件流程

  1. 在每个步骤之后添加调试节点以跟踪数据
  2. 查看 Node-RED 日志以获取详细错误信息
  3. 如有需要,请使用外部邮件客户端测试 SMTP 设置
  4. 验证从相机到 Gmail 服务器的网络连通性

成功!您的邮件集成已完成

您的 OV80i 相机现在可以:

✅ 自动发送检查结果的电子邮件通知

✅ 提供带检查详情的丰富且格式化的消息

✅ 支持多收件人及升级工作流

✅ 提供定期报告和摘要

✅ 根据检查结果处理条件消息

最佳实践

邮件管理

  • 使用描述性主题,带有清晰的状态指示
  • 保持消息简洁但信息充分
  • 包含时间戳和工位标识
  • 在通知中提供可执行的信息

安全性与可靠性

  • 保护应用密码 - 安全存储并定期轮换
  • 为系统通知使用专用邮箱账户
  • 定期测试邮件投递以确保可靠性
  • 监控投递失败情况并具备备用通知方法

性能考虑

  • 限制电子邮件发送频率 以避免垃圾邮件检测
  • 为不同告警类型使用适当的收件人名单
  • 对高容量系统实施速率限制
  • 在包含大附件时考虑邮件大小

下一步

设置电子邮件通知后:

  1. 为不同类型的告警创建电子邮件模板
  2. 为不同利益相关者设置分发列表
  3. 为关键问题实现升级工作流
  4. 为管理层创建定期报告
  5. 与其他通知系统集成(SMS、Teams 等)

🔗 参见下列